Ê


                             QTrashª INIT Ñ Version 1.0§1
                       Copyright © 1991 by Jon L. Grushka II
                   Developed using SymantecÕs THINK C 4.0.5.
              Portions of this code Copyright © 1991 Symantec.
                 AutoExtractor Copyright © 1991 Bill Goodman.

©© This release may only be uploaded to GEnie, and only by me! ©©
© User-to-user distribution is approved, see restrictions below. ©


Ê
ABOUT THIS DOCUMENT:

This is the documentation for QTrashª, an INIT that deletes empty folders.  This document was prepared using TeachText 7.0 so as to make it readily available to all users.  If you distribute a non- TeachText copy of this documentation, please include this copy as well.  Thanks!


WHAT DOES QTRASHª DO?

QTrashª will delete all empty folders from the startup volume.  Some folders are exceptions to this.  They are:

¥	Apple Menu Items
¥	Control Panels
¥	Control Panels (disabled)
¥	Desktop Folder
¥	Extensions
¥	Extensions (disabled)
¥	Preferences
¥	Spool Folder
¥	Startup Items
¥	System Extensions
¥	System Extensions (disabled)
¥	Temporary Items
¥	Trash

If you wish to extend this list on your own, use ResEdit (or other resource editor) to edit the STR# resource.  If you are ordering a copy of QTrashª on diskette, IÕll be more than happy to add to the list for you.


WHAT DO I NEED TO USE QTRASHª?

Good question (bad answer).  At this time, I have personally tested QTrashª in the following environments:

¥	Mac SE running System 7.0.
¥	Mac SE with Radius 16MHz accellerator running System 6.0.7
¥	Mac II running System 6.0.7 (no, I donÕt have color icons yet)

I hope to be able to test it on a Mac IIx soon, as well as on a Mac SE with the NewLife 16 (or the TransWarpª SE).  As people try it out on other Macs and with other Systems and let me know what works and what doesnÕt, IÕll update the documentation.

BTW, I seem to recall a warning in Inside Macintosh Volume IV about hierarchical directory routines.  QTrashª uses the low-level function PBGetCatInfo.  If youÕve got 64K ROMs and arenÕt using HFS by now, IÕm sorry Ñ you probably canÕt use QTrashª.


WHY USE QTRASHª IN THE FIRST PLACE?

Personally, IÕm rather picky about the layout of files and folders on the volumes I manage at work.  I am constantly finding folders such as ÒEmpty FolderÓ, ÒCopy of Empty FolderÓ, ÒCopy of Copy of Empty FolderÓ, etc. Ñ all with no files.  One would think that ÒusersÓ would have better things to do with their time.  Oh, well...

This is why I wrote QTrashª.  That and IÕve finally managed to find sufficient time to learn C on the Macintosh (IÕm learning C and Macintosh programming at the same time, so itÕs slow going).

BTW, I was going to include a ShowINIT resource, but couldnÕt find source references for such (only working copies in commercial INITs which I canÕt legally distribute).


WHATÕS THIS SHAREWARE STUFF ABOUT?

People like me occasionally come up with what we think are Òneat ideasÓ, and then do something about them.  When weÕve done the best we think we can, we upload them to information services like GEnie, hoping that others will also find them useful.  Although we have no means of forcing people to pay for our work, we trust that most people are basically honest and will register their copy if they find it useful.  Normally, the ShareWare fee isnÕt much; itÕs more of an incentive to the author to improve on existing programs and to think up new ones as well.  I have a few other ideas floating about in my head, but for right now, IÕll see what happens with this one.

If you donÕt find QTrashª useful, thatÕs OK.  I didnÕt intend for this to be the next most-requested downloadable file on GEnie.  Please destroy, or better yet, give your copy to someone else that might.  Thanks for taking the time to look it over.  Perhaps youÕll drop me a note as to what you didnÕt like.

If you are one of those people who find QTrashª useful, great!  I hope it will help take a little more stress out of your life as well.

If you are also one of those people that registers their ShareWare, even better!  The ShareWare fee for QTrashª is U.S. $5.00, or $10.00 if youÕd like a copy on diskette.  If you want the diskette, please specify whether youÕd prefer 400K, 800K, or 1.4MB.  Yes, itÕs only a 4K file (and this document isnÕt that large either, although it is larger than the INIT!), but you are in effect paying for the diskette as well, so you might as well get one you can make good use of.  However, I donÕt want to send you a diskette you canÕt read, either, so diskettes will be formatted as 400K unless otherwise specified.  Also, if you want the diskette, let me know if you would like any additional folders added to the exclusion list.  Modifying the STR# resource is easy.

Please make checks or money orders payable to:
Jon L. Grushka II
PO Box 214
Addison, IL  60101-0214

I can also be reached on GEnie at J.GrushkaII1.


SHAREWARE LICENSE AGREEMENT:

Yes, this should be fairly serious, but ShareWare should be fun too.

1. GRANT OF LICENSE.  Payment of the ShareWare fee for QTrashª (the ÒSOFTWAREÓ) grants to you the right to use the SOFTWARE on as many CPUs as you have at one site.  You may network the SOFTWARE or otherwise use it on more than one computer or computer terminal at the same time, provided you do not allow access to the SOFTWARE from off-site computers, terminals, or networks.  This does not include information services such as GEnie (see INFORMATION SERVICES below).  Basically, IÕm not going to ask for $5 per Mac Ñ that would be silly.  However, it isnÕt fair to me if an organization has a nation-wide network and only pays for a single copy.  So letÕs keep things reasonable, okay?  BTW, ÒunlimitedÓ licenses can be had...

2.	COPYRIGHT.  The SOFTWARE belongs to Jon L. Grushka II (thatÕs me) and I retain all rights to the SOFTWARE at all times.  This includes the source code, object code, icon, and name.  Basically, I wrote it, so itÕs MINE.  This excludes portions of this code derived from the THINK C libraries, which belong to Symantec.  They do nice work!

3.	DISTRIBUTION.  You may NOT rent or lease the SOFTWARE, nor distribute the SOFTWARE for ANY fee (reasonable or otherwise).  THIS ALSO MEANS YOU, EDUCORP!  People like me donÕt write software like this for organizations like you!  You may give away the SOFTWARE to any of your friends or associates, as long as you include the documentation (this file).  If I find QTrashª being distributed in any unapproved manner or form or by anyone not authorized to do so, I will not be happy.

4. INFORMATION SERVICES.  The SOFTWARE is NOT, I repeat, NOT to be uploaded, transferred, or otherwise made available to information services without the express WRITTEN permission of the author (Jon L. Grushka II).  I have friends on other networks (and they told two friends, and so on,...) that will let me know if they find it.  I wonÕt be happy if they do.  If you are a SYSOP or other BBS or information service manager, please contact me by mail or on GEnie if you wish to make QTrashª available to your users.

EXCEPTION: Any information service that I personally upload these files to has my permission to evaluate these files themselves, and post them (or not) in their software library(s).  As my personal preference is GEnie (in case you couldnÕt tell by now), GEnie will probably be the first source for non-alpha copies of QTrashª and anything else I write.

5.	TIME AND OTHER LIMITATIONS.  In general, I donÕt believe in time-locked software.  There are enough people out there already that donÕt care what day their Mac thinks it is.  Of course, how many time-locks have low AND high limits...  Anyway, hereÕs the deal.  Try QTrashª for 15 days.  If you like it and continue to use it, please register your copy.  If not, please destroy or give away your copy.  BTW, unregistered copies are unsupported copies.

6.	NO PROMISES, NO WARRANTIES, NO GUARANTEES, NO LIABILITY FOR CONSEQUENTIAL DAMAGES, NO FRUIT CUP!  The user assumes all liability and responsibility for using the SOFTWARE.  You should always follow good backup and anti-virus procedures.  IÕve checked out QTrashª with Disinfectantª myself, and detected no viruses as of the time this file was distributed.  My original source, project, and resource files are kept on a locked floppy away from my Mac (and magnetic fields, heat, humidity, direct sunlight, and cat hair).


Any similarities between QTrashª and any other folder-deleting utility, fictitious or non-fictitious, past, present or future, alive or dead, is purely coincidental.  So there.  : )


CHEAP IMITATION DIET REGISTRATION FORM:
========================================

Name:_______________________________________________

[Company:]___________________________________________

Address:_____________________________________________

City, State Zip:________________________________________

Number of copies:               _____ @ $  5.00 = $__________

Number of diskette copies: _____ @ $10.00 = $__________

TOTAL ENCLOSED: $__________